home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / fract30.zip / FRACT.DOC < prev    next >
Text File  |  1989-09-29  |  14KB  |  274 lines
  1. ===============================================================================
  2.               Mandelbrot/Julia set 2D/3D EGA/VGA Fractal Generator
  3.                      Written by Tom Collins and Dan Rowley
  4.                    (C) 1989 by Innovative Computer Solutions
  5.                           Documentation for FRACT v3.0
  6. ===============================================================================
  7.                                Shareware Notice
  8. -------------------------------------------------------------------------------
  9.  
  10. This program is shareware.  Please play with it for a few days.  If you grow
  11. attached to it, register it.  If you sell computers/monitors/VGA cards, and
  12. you use my program to show off the capabilities of such devices, I'd like you
  13. to register FRACT.  (Think about it this way, you're using my program to make
  14. money.  If it impresses someone enough to buy a VGA monitor/card, I think it's
  15. worth it to you to send me a few bucks.)
  16.  
  17.      [See the 'Registration' section at the end of this file for more info]
  18.  
  19. -------------------------------------------------------------------------------
  20.  
  21. You should have the following files on your disk:
  22.  
  23.        FRACT.EXE - The actual Fractal Generator.
  24.        FRACT.DOC - This documentation.
  25.        FRACT.NEW - What's been changed from previous versions.
  26.     REGISTER.FRM - Registration form
  27.     ????????.IMG
  28.     ????????.DAT - Sample images and data files for use with FRACT
  29.  
  30. If any of these files are missing, please call one of the boards listed at the
  31. end of this file to get a good copy.  When redistributing this program, be sure
  32. to include all of the above files.
  33.  
  34. -------------------------------------------------------------------------------
  35.                                 How to Use FRACT
  36. -------------------------------------------------------------------------------
  37.  
  38. Any time the computer is drawing a image, hitting the 'S' key or the left
  39. button on the mouse will save the image.  Pressing the escape key or the right
  40. mouse button will abort the image without saving it. If you save an image,
  41. you'll be able to continue drawing it at another time.
  42.  
  43. Menu items and their associated functions:
  44.  
  45. Create a 2-D Mandelbrot image
  46. -----------------------------
  47.      The program will ask you for the x (real) and y (imaginary) coordinates
  48.      corresponding to the center of the image.  You will then be prompted for
  49.      the side length and the filename to save the image under.  Leaving the
  50.      filename field blank will cause the image to be drawn without saving.
  51.  
  52.      [Note:  The Mandelbrot set is contained within the x coordinates (-2.1 and
  53.      +0.7) and the y coordinates (+1.4 and -1.4).  You can create an image of
  54.      the Mandelbrot set by using the following data:  x:-0.7, y:0, side:2.8.]
  55.  
  56.      The image will be drawn with dots separated by progressively smaller
  57.      spaces.  This should give you some idea of what the image will be like so
  58.      you can abort it early if you don't like it.
  59.  
  60.  
  61. Create a 3-D Mandelbrot image
  62. -----------------------------
  63.      The only difference between the 2-D and 3-D versions of the Mandelbrot
  64.      images is the method used to draw the image.  The 3-D image is drawn with
  65.      diagonal lines starting from the upper right-hand corner.
  66.  
  67.  
  68. Create a 2-D Julia image
  69. ------------------------
  70.      The program will ask you for the x and y coordinates corresponding to a
  71.      point on the Mandelbrot Set.  This is the point from which the Julia set
  72.      will be drawn.
  73.  
  74.      The Julia image will be drawn from both sides, as it is symmetric about
  75.      the origin.
  76.  
  77.  
  78. Create a 3-D Julia image [registered version only]
  79. --------------------------------------------------
  80.      Once again, the only difference between the 2-D and 3-D versions of the
  81.      Julia sets is the method used to draw the image.  Like the 3-D Mandelbrot,
  82.      the 3-D Julia will be drawn with diagonal lines starting from the upper
  83.      right-hand corner.
  84.  
  85.  
  86. Continue drawing an old image
  87. -----------------------------
  88.      A list of available files will be displayed.  After choosing a file, the
  89.      image will be loaded and the program will pick up from where it left off.
  90.      Hitting escape from the list of files will return you to the main menu.
  91.  
  92.  
  93. Remove registration notices [registered version only]
  94. -----------------------------------------------------
  95.      This option will remove the 'Register Your Software' message from a file
  96.      chosen from the file list.
  97.  
  98.  
  99. Add extra sets of iterations
  100. ----------------------------
  101.      This feature is used to improve the quality of some images.  Adding extra
  102.      iterations redraws black areas of the image, possibly adding more color.
  103.      Each set of iterations adds approximately 200 actual iterations to the
  104.      computations for each dot [the image starts out with 200 iterations].
  105.      Adding iterations will slow down the generation of the image, and it is
  106.      advised that you add at most 5 sets.  [Note:  Adding is cumulative.]
  107.  
  108.  
  109. Load and view image
  110. -------------------
  111.      You will once again go through the file selection menu.  After choosing an
  112.      image it will be loaded and displayed on the screen [EGA images take
  113.      longer than VGA.  VGA images will be faded onto the screen].
  114.  
  115.      While the image is still on the screen the following options are
  116.      available:
  117.           Pressing 'X' will change to and from an 'X-ray' palette.  This
  118.           occasionally produces some interesting effects.
  119.  
  120.           Pressing the space bar will cause the palette to rotate giving the
  121.           illusion of movement.  Pressing the space bar again will stop the
  122.           rotation.  If you are using a mouse, pressing the left button will
  123.           start the palette changing and pressing the right button will stop
  124.           it.  While holding the left button down, the speed of rotation can be
  125.           adjusted by moving the mouse horizontally.
  126.  
  127.           Pressing escape or the 'Q' key will bring you back to the main menu.
  128.  
  129.  
  130. Get info on an image
  131. --------------------
  132.      This option will display pertinent information on any image you choose.
  133.  
  134.  
  135. Zoom in to create a new image
  136. -----------------------------
  137.      This option allows you to choose any point on an existing image and
  138.      magnify it to create a new image.  Choose the point by using the arrow
  139.      keys/numeric keypad on the keyboard or the mouse.  Clicking the left
  140.      mouse button, or pressing 'M' or Enter on the keyboard will create a
  141.      Mandelbrot image.  Clicking the right mouse button, or pressing 'J' will
  142.      create the corresponding Julia Set for that point.  When creating a new
  143.      Mandelbrot image you will be asked for a magnification factor [Note:  25
  144.      is a good factor].  When creating any image, you will also be asked for a
  145.      filename to save the image under.
  146.  
  147.  
  148. Slide Show of all images [registered version only]
  149. --------------------------------------------------
  150.      This option will cycle through all of the images in the current directory,
  151.      displaying and rotating the palette for a short period of time before
  152.      loading the next image.  VGA images will fade in from black, and then fade
  153.      back to black after cycling.  Press escape to abort the slide show.
  154.  
  155.  
  156. Quit
  157. ----
  158.      Clears the screen and drops to DOS.
  159.  
  160.  
  161. -------------------------------------------------------------------------------
  162.                                      History
  163. -------------------------------------------------------------------------------
  164. I've been interested in Fractal Geometry, especially the Mandelbrot Set, ever
  165. since my father tried to write a program from algorithms appearing in the
  166. August 1985 Scientific American Computer Recreations column.  When I first saw
  167. the program, it was on my Apple IIe.  Written in BASIC, it plotted black and
  168. white dots on the hi-res screen in a square of 100 pixels per side.  I
  169. modified the program to use the full screen (280x192) and the 5 colors that
  170. Apple hi-res is limited to.  I got bored fast, so I rewrote the program using
  171. som